OpenAI Codex 官方最佳实践：直接可用的框架
OpenAI Codex 官方最佳实践：直接可用的框架
大多数人用 AI coding agent 效果差，不是因为模型不行，是因为用法不对。
核心框架：每个 Prompt 要包含 4 件事
| 要素 | 说明 | 示例 |
|---|---|---|
| 目标 | 要改什么 | “添加用户登录功能” |
| 上下文 | 哪些文件/错误相关 | “修改 auth.js，处理 JWT 过期场景” |
| 约束 | 架构规范、禁止事项 | “使用 TypeScript，禁止直接操作 DOM” |
| 完成标准 | 什么叫做完了 | “跑通测试用例 1-5，用户可正常登录” |
少一个，Codex 就开始瞎猜。
AGENTS.md：被忽视的杀手锏
它是给 agent 自动加载的 README，包含：
- 项目结构
- 构建命令
- 测试怎么跑
- PR 规范
- 禁止操作
配置一次，永久生效。 当 Codex 反复犯同一个错，不是去骂它，而是更新 AGENTS.md。
复杂任务：先规划再动手
用 /plan 模式让它先问清楚再写代码，而不是直接开冲。
写到一半你才发现方向跑偏了，修改成本更高。
Review 也是 Codex 的事
改完代码让它：
- 跑测试
- 检查 lint
- 自己 review diff
- 确认行为符合预期
这个闭环不配置，你就得自己当 QA。
重复工作流：封装成 Skill + Automation
- Skill：定义「怎么做」
- Automation：定义「何时做」
最容易犯的错
| 错误做法 | 正确做法 |
|---|---|
| 一个项目一个线程 → 上下文膨胀 | 不同项目用不同线程 |
| 手动跑通之前就自动化 → 批量出错 | 先验证再自动化 |
| 所有规则塞进 prompt → 混乱 | 放进 AGENTS.md 统一管理 |
核心观点
Codex 不是「一次性助手」，是需要你持续配置和改进的队友。
越早把它当工程资产来维护，它就越能帮你省时间。
参考来源：OpenAI Codex 官方最佳实践